home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / os2 / fc011.zip / fc.doc < prev    next >
Text File  |  1993-04-28  |  11KB  |  281 lines
  1.                             File Commander/2 V0.11
  2.                             ----------------------
  3. ****************************************************************************
  4. Note: If you are experiencing Trap 000E or exception in driver KBD$ (often
  5. triggered by an Alt-Esc) when using this FC/2 or v0.10, look at the "nokbd"
  6. directive in the configuration section near the end of this document.
  7. ****************************************************************************
  8.  
  9.   File Commander/2 is intended to be an OS/2 version of the popular Norton
  10. Commander(tm) DOS program. It implements a subset of the features provided by
  11. Norton Commander but adds some features of its own that are only possible
  12. under OS/2.
  13.   This is a preliminary release of File Commander/2. I have released it to
  14. get some feedback as to how many people are interested in this type of
  15. program. The software is currently free, however any donations will be
  16. gratefully accepted. The more support I get (especially monetary), the more
  17. likely it'll be that I'll continue development of the program. See the end of
  18. this file for how to contact me.
  19.   I would like to thank the people responsible for the EMX/GCC package,
  20. especially the video library, for making this program much easier to write.
  21.  
  22. The following features of Norton Commander are NOT (yet) implemented:
  23.     Online Help
  24.     User Menu
  25.     File search
  26.     File tree
  27.     History window
  28.     Pull down menus and most functions on them
  29.     (there may be some others I've forgotten)
  30.  
  31. So after all that, you may be wondering what IS implemented?  Well here is a
  32. list of keys and their functions:
  33.  
  34. F1: Brings up the .inf file(s) of your choice. (See section on Configuration)
  35.  
  36. F3: Views the current file with the viewer of your choice (no internal).
  37.  
  38. F4: Edits the current file with the viewer of your choice (no internal).
  39.  
  40. F5: Copies the current file or currently tagged files. Default destination
  41.     directory is that of the opposite panel.
  42.  
  43. F6: As above but moves the file(s).
  44.  
  45. F7: Make a directory. You are prompted for the name of the directory.
  46.  
  47. F8: Delete current file or tagged files. There is a double confirmation on
  48.     a tagged file delete.
  49.  
  50. F10:Exit program.
  51.  
  52. Esc: Clear command line.
  53.  
  54. Tab: Switch cursor between panels.
  55.  
  56. Ctrl-E: Scroll back through command history. Note that this wraps around.
  57.         ie pressing Ctrl-E when the oldest command is showing will bring up
  58.         the newest command.
  59.  
  60. Ctrl-X: Scroll forward through command history.
  61.  
  62. Ctrl-R: Re-read the current panel. (Useful if you changed a floppy or if
  63.         another process has altered the directory contents.
  64.  
  65. Ctrl-J: Insert name of current file into command line or if there is a
  66.         non-space character before the cursor searches history. Note that
  67.         only text before the cursor is used when looking for a match in
  68.         history. Note also that if pressed again, the next match from history
  69.         will be recalled. This key alters the history position used by Ctrl-E
  70.         and Ctrl-X.
  71.  
  72. Ctrl-Enter: Same as Ctrl-J.
  73.  
  74. Enter: Execute command line, or if command line is empty, execute current
  75.        file. If the file matches an association, then the program associated
  76.        with it will be used on the file (See Section on Configuration).
  77.  
  78. Alt-Enter: Same as above but the executable is run in a separate session.
  79.  
  80. Ctrl-O: Turn panels On/Off. Useful if you want to see the output of the
  81.         program you just ran or if you just want a command line for a while.
  82.  
  83. Ctrl-\: Moves to the root directory of the current drive.
  84.  
  85. Ctrl-L: Toggles drive information panel on/off. Shows drive total space, free
  86.         space, number of files and total bytes occupied by current directory.
  87.  
  88. Insert: Tag/Untag current file and move cursor down.
  89.  
  90. Home: Moves cursor to the first file on the panel.
  91.  
  92. End: Moves cursor to the last file on the panel.
  93.  
  94. Ctrl-Home: Moves command line cursor to the start of the line.
  95.  
  96. Ctrl-End: Moves command line cursor to the end of the line.
  97.  
  98. Cursor Up/Down: Moves the cursor up or down one file name. Will scroll window
  99.                 if necessary. Also if panels are off, scrolls through history.
  100.  
  101. Cursor Left/Right: Moves the command line cursor.
  102.  
  103. Grey +: Tag files by wildcard. Note that this uses REAL wildcards.
  104.         ie "*" matches EVERYTHING, "*x*" matches everything with an 'x' in it,
  105.         "??*" matches everything with 2 or more characters, etc.
  106.  
  107. Grey -: Same as above, only UNTAGS.
  108.  
  109. Alt-letter/number: Holding down ALT and typing a partial file name will move
  110.         the cursor to the first file matching that partial name.
  111.  
  112.  
  113.  
  114.  
  115. Why use File Commander/2 instead of Norton Commander in a DOS session?
  116. ----------------------------------------------------------------------
  117.  
  118. FC/2 offers the following benefits over Norton Commander in a VDM:
  119.  
  120.      HPFS long filename support. Long names can be seen and used wherever
  121.           you would expect. Also if no files are tagged, up to 36 characters
  122.           of the current file name are displayed at the bottom of the panel.
  123.           If file name is to long to fit in the file name column of the panel,
  124.           the first 12 characters are shown with an arrow indicating there is
  125.           more. Also the case of file names isn't lost.
  126.  
  127.      Can execute OS/2 programs (PM and text mode) as well as DOS and Windows
  128.      programs.
  129.  
  130.      Can spawn off child processes (Run commands in a separate session).
  131.  
  132.      Doesn't hog CPU time when idle.
  133.  
  134.      Better wildcards.
  135.  
  136.      Copy/Move will handle a directory tree if the source file name is a
  137.      directory.(Note: if moving a tree between drives (or partitions), the
  138.      source directory is not deleted, yet...to be fixed).
  139.  
  140.      Starts up faster (no VDM to start).
  141.  
  142.      Uses less system resources than a DOS session. (a VDM uses ~1MB of
  143.      system memory).
  144.  
  145.      Association by wildcard instead of just extension.
  146.  
  147.  
  148.  
  149.  
  150. Configuration
  151. -------------
  152.   Configuration is done with the file fc.ini which must be in the same 
  153. directory as fc.exe. It contains statements in the form:
  154.  
  155. keyword=value
  156.  
  157. to set a configuration setting (see below for valid forms) or
  158.  
  159. wildcard:program
  160.  
  161. to create an association. The effect of this is to use "program" on any file
  162. matching "wildcard" when ENTER is pressed on the file.
  163.  
  164. e.g.
  165.  
  166. *.zip:unzip
  167. *.inf:view
  168. *.ico:iconedit
  169. *.zoo:zoo x
  170. *.tif*:pmview
  171. (matches both x.tif and x.tiff, not actually sure if pmview handles tiffs...)
  172.  
  173.  
  174. Do NOT use spaces around the '=' or ':' or at the start of the line.
  175. Any line not containing an '=' or ':' will be ignored entirely.
  176. Do not use quotes around string values. (used below for clarity only)
  177.  
  178. Configuration keywords are:
  179.  
  180. background      String prepended to a command to start it in a separate
  181.                 session. Default "start /f /c"
  182.  
  183. clock=12|24|off    Specifies whether a clock should be shown and what type.
  184.  
  185. editor          name of editor used when F4 is pressed. Default is "e"
  186.  
  187. help            names .inf files viewed by pressing F1.
  188.                 eg 4os2.inf+cmdref.inf
  189.  
  190. hidden=on|off   Specifies if hidden files will show up. Default off.
  191.  
  192. nokbd=on|off    If set to on, disables use of the OS/2 API keyboard subsystem.
  193.                 Use this if you are experiencing Trap 000E or exception in 
  194.         driver KBD$. This seems to be due to a bug in the Dec 2.1 beta.
  195.                 The catch is that with this option on, you must use 
  196.                 Alt-grey +/- to tag/untag files instead of just grey +/-
  197.                 If you find you need this option, please contact me telling
  198.                 me which version of OS/2 you are using and a little bit
  199.                 about your setup.
  200.  
  201. numlock=on|off  Specifies if numlock should be fixed on or not (affects both
  202.                 FC/2 and any program started by FC/2.
  203.                 Note: does NOT work for a windowed session as PM keeps its own
  204.                 idea of keylock status.
  205.  
  206. right           directory that the right panel starts in. The left panel is
  207.                 always the current directory.
  208.  
  209. saver        Specifies number of minutes before the screen saver starts.
  210.  
  211. viewer          name of file viewer used when F3 is pressed. Default is "list"
  212.                 as in the one built into 4os2.
  213.  
  214.  
  215.  
  216. Contacting the Author
  217. ---------------------
  218. I would appreciate some feedback including bug reports, suggestions, most
  219. missed NC features etc.
  220. You can contact me by either of the following means:
  221.  
  222. Internet: s902150@minyos.xx.rmit.oz.au
  223. (at least until end of 1993)
  224.  
  225. Snail Mail:     Brian Havard
  226.                 16a Rennison St,
  227.                 Mordialloc 3195,
  228.                 Victoria
  229.                 AUSTRALIA
  230.  
  231.  
  232. ------------------------------------------------------------------------------
  233. Since this software is free, it is supplied WITHOUT ANY WARRANTY;
  234. without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  235. A PARTICULAR PURPOSE. It is supplied as is, in the hope that people
  236. will find it useful.
  237.  
  238. You are free to copy this software ONLY if you include this document file with
  239. it. You may NOT charge anyone for a copy of this software other than a small
  240. copying fee. You may NOT include this software with any commercial software
  241. without the consent of the author.
  242.  
  243. Norton Commander is a trademark of Symantec Corporation.
  244. ------------------------------------------------------------------------------
  245.  
  246.  
  247. Release History
  248. ---------------
  249. 13/4/93 v0.1   Initial Release
  250.  
  251. 27/4/93 v0.11
  252. - Fixed bug that caused lockup if a history search found no match.
  253.  
  254. - If an executed program changes directory contents, cursor stays on same
  255.   file name.
  256.  
  257. - Improved logic of and documented file name seeking. (Alt-letter/number)
  258.  
  259. - Added clock.
  260.  
  261. - Added screen saver.
  262.  
  263. - Cursor should now be in the right place after changing up a directory.
  264.   This was only wrong after using Alt-F1/F2 to change to a drive who's default
  265.   directory was not its root.
  266.  
  267. - 43/50 line mode support added. As the EMX static link library doesn't
  268.   support >25 lines, emx.dll is now required.
  269.   Note that in a windowed session you can have as many or few lines as you
  270.   like although things start getting a little mixed up with less than 16.
  271.   Before running FC, use "mode co80,n" where n is the number of lines.
  272.  
  273. - No harderr popup if no disk in drive.
  274.  
  275. - Option to deselect use of KBD subsystem if causing traps.
  276.  
  277. - ".." entry not shown at root of HPFS drive.
  278.  
  279. - Several other minor bugs I didn't bother to note down.
  280. 
  281.